Creates a new directory (folder) inside the specified parent directory.

OSErr PBCreateDirectoryUnicodeSync (
    FSRefParam *paramBlock
);

paramBlock

A pointer to a parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion routine.

• ioResult

  On output, the result code of the function.

• ref

  On input, the parent directory where the new directory is to be created.

• nameLength

  On input, the number of Unicode characters in the directory's name.

• name

  On input, a pointer to the Unicode name of the new directory.

• whichInfo

  On input, which catalog info fields to set. This field is optional and may be set to NULL.

• catInfo

  On input, the values for catalog info fields to set. This field is optional and may be set to NULL.

• newRef

  On output, a pointer to the FSRef for the directory. This field is optional and may be set to NULL.

• spec

  On output, a pointer to the FSSpec for the directory. This field is optional and may be set to NULL.

• ioDirID

  On output, the directory ID of the directory.

You may optionally set catalog information for the new directory using the whichInfo and catalogInfo parameters; this is equivalent to calling FSSetCatalogInfo after creating the directory. If possible, you should set the textEncodingHint in the catalogInfo.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)